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1 .  Scope. 

This  Version  Description  Document  (VDD)  contains  a  fimctional  description  of  the  Rotary 
Wing  Aircraft  (RWA)  system,  all  modules  in  this  release  ictentifled  by  version  number,  a 
set  of  build  instructions,  installation  procedures,  identiHcation  of  any  known  problems, 
release  notes  and  any  essential  data  relationships  t^t  are  a  part  of  this  release. 

1.1  Identification. 


This  VDD  defines  the  5  November  1992  initial  release  of  Rotary  Wing  Aircraft  (RWA), 
release  version  BDS-D  RWA  1.0.0. 

1.2  System  Overview. 

Stddirar  in  tte  loop  simulators  exist  at  the  Aviation  Test  Bed  (AVTB)  located  at  Ft  Rucker, 
Alabama  and  the  Qose  Combat  Test  Bed  (CCTB)  located  at  Ft  Knox,  Kentucky.  The 
simulators  include  Rotary  Wing  Aircraft  (RWA,  onl>  at  Ft  Rucker),  Ml  tanks,  Bradley 
Hghting  Vehicles,  Fixed  Wing  Aircraft  (I^A),  a  Management  Command  and  Control 
system  (MCC),  Non  Line  of  Sight  vehicle  (NLOS,  located  at  Ft  Knox  only),  and,  finally, 
a  Semi-Automated  Forces  system  (SAFOR).  The  RWA  provides  major  en^cements  to 
the  next  generation  of  rotary  wing  simuladotis  and  develoj^  reconfigurable  simulators  with 
improved  visuals,  sensor  models,  and  flight  dynamics. 

1 . 3  Document  Overview. 

This  document  was  prepared  in  accordance  with  DID  DI-MCCR-SOOISA  of  DOD-STD- 
2167A  and  defines  me  5  November  1992  rdease  of  tte  RWA  software.  Version  BDS-D 
RWA  1.0.0.  This  release  contains  the  initial  software  capture  of  the  SIMNHT  RWA, 
Version  6.6.1. 

2 .  Referenced  Documents. 


2.1  Government  Documents. 

DI-MCCR-8(X)13A  Vmsion  Description  Document  29  February  1988 

DCX>^rn>*2167A  Defense  System  Software  Development 

29  Februa^  1988 

2.2  Non-Govemment  Documents. 

ADST/WDL/rR~92-(X)640-YRl  AdvaiKed  Distributed  Simulation  Technology 

System  Definition  Document  28  October  1992 

ADST/WDI/rR~92-003023  ADST  Configuration  Managonent  Han 

30  Novmnber  1992 

ADST/WDL/lR-92-003028  RWA  Coldstart  Procedures,  22  November  1992 
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3 .  Version  Description. 


Vetsicm  BDS-D  RWA  1.0.0  of  the  RWA  is  to  be  installed  at  Fort  Rucker,  Alabama. 

3.1  Inventory  of  Materials  Released. 

Listed  below  is  the  physical  media  and  support  documentation  required  to  build,  load  and 
operate  the  RWA  system.  The  RWA  release  version  BDS-D  RWA  1.0.0  consists  of  all  the 
source  code  needed  to  build  the  system,  executable  and  data  files  required  to  run  the  syston 
and  GTOS  4.7  operating  system. 

Type  ID  No.  Title 

DC  6150  Tape  BDS-D  1.0.0  RWA  Initial  6.6.1  T/0 

GTOS  4.7  Operating  System 

Document  ADST/WDL/TR~92-003028  RWA  Coldstart  Procures 

Document  ADST/WDiyrR-92-003027  RWA  BDS-D  1.0.0  VDD 

3.2  Inventory  of  CSCI  Contents. 

Appendix  D  provides  a  listing  of  all  RWA  CSCI  source  files  which  were  used  to  create 
ruease  BDS-D  RWA  1.0.0.  source  files  teade  on  dte  Configtmttion  Management  and 
Control  Sun  Sparc  wodtstation  and  are  configuration  controlled  using  the  Revision  Control 
System  (RCS). 

3.3  Changes  Installed. 

Since  RWA  release  vtnsion  BDS-D  RWA  1.0.0  captures  the  SIMNET  6.6.1  software 
product  baseline,  no  SP/CRs  were  written  and/w  included  in  this  release. 

3.4  Adaptation  Data. 

Adimtation  data  is  contained  in  human  editabte  files  which  allow  modification  to  the  flight 
mo^  and  weapon’s  system. 

3.5  Coldstart  Procedures. 

The  sqrarate  RWA  Cold  Start  Procedures,  document  no.  ADST/WDL/rR-92-003028, 
provid^  deuuled  cold  start  instructions  for  the  BDS-D  RWA  1.0.0  release. 

3.6  Build  Instructions. 


^^[midix  B  provides  detailed  build  instructions  for  the  RWA  BDS-D  1.0.0  initial  software 
rdease. 


3.7  Regression  Test  Results. 

RWA  legressitHi  te^  scenario  and  results  are  included  in  appendix  A. 

3.8  Release  Notes. 

3.8.1  RWA  BDS-D  1.0.0  Software  Release  Notes. 

No  release  notes  available  for  the  RWA  BDS-D  1.0.0  application  software  initial  release. 
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3.8.2  GTOS5.7  Operating  System  Software  Release  Notes. 

^[>pendix  D  contains  the  GTOSS.7  Operating  System  software  release  notes  prepared  by 
BBN  Systems  and  Technologies  Corporation. 

3.9.  Interface  Compatibility. 

This  release  remains  compatible  with  the  SIMNET  interfaces. 

3.10.  Bibliography. 

Management,  Command  and  Control  System  (MCC)  Operations  Documentation 
Report  No.  IEITR-74563;  15  March  1990. 

3.11.  Summary  of  Changes. 

Initial  release.  No  summary  of  changes  to  baseline  ate  available. 

3.12.  Installation  Instructions. 

Appendix  C  contains  the  current  build  install^on  procedures  for  the  BDS-D  RWA  1.0.0 
vosion  release. 

3.13.  Possible  Problems  and  Known  Errors. 

There  are  no  open  SP/CR’s  pertaining  to  this  sj^mm  release. 
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4.  Notes. 


The  following  is  a  list  of  acronyms  used  in  this  document 


ADST 

Avra 

BBN 

CCTB 

FWA 

MCC 

NLOS 

RWA 

SAPOR 

SIMNET 

SP/CRs 

VDD 


Advanced  Distributed  Simulation  Technology 

Aviation  Test  Bed 

Bolt,  Beranek,  Sc  Newman 

Close  Combat  Test  Bed 

Hxed  Wing  Aircraft 

Management,  Command  and  Control  system 

Non  Une  of  Si^t 

Rot^  ^^g  Aiioraft 

Semi- Automated  Forces  system 

Software  Problem/Change  Reports 
Version  Description  Doc^ent 
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Appendixes. 

Appendix  A  RWA  Regression  Test  Results 


RWA _ Simulator  Testing  Scenario 

PURPOSE;  To  set  un  RWA  test  conditions  from  MCC 

1 . )  Ensure  that  the  Master  Command  &  Control  (MCC),  RWA  simulator.  Plan  View 
Display  (PVD)  and  Stealth  are  not  in  use.  Place  the  MCC  in  an  initialization  mode  by 
rebooting  the  Simnet  Control  Console  (SCQ  Macinto^.  Place  the  RWA  simulator  in  the 
initializaticm  mode  by  following  the  RWA  Simulator  Startup  Procedure  selecting  MCC 
control  At  die  RWA.  the  last  message  to  appear  on  GTl  will  be:  SYSTEM 
INmALIZATION  COMPLETE. 

2. )  At  the  MCC,  the  Simnet  MCC  main  screen  will  be  displayed.  Mcxise-cUck  the 

[START]  button.  When  die  "Exercise  Initialization"  screoi  appears,  select  the  [NEXT] 
button,  repeat  for  the  next  three  (3)  screens.  This  sets  up  default  conditions.  For  the  next 
screen,  sdect  A  Company  [DEFENSE]  button,  B  Company  [OFFENSE]  button,  C 
Company  [NON-PARTICIPANT]  button  and  D  Company  [NON-PARTlCIPANr]  button. 
Thm  select  [NEXT]  button.  The  next  screen  will  ask  if  aJl  is  OK  or  clunges  are  to  be 
made.  Select  OK  to  start  the  exercise. 

3. )  The  next  screen  will  contain  severed  selection  icons.  Select  [Simulator  AUocatitm] 

di»  select  [GO].  A  screen  labeled  "Vehicle  Simulator  Altocation"  wdl  appear.  Sdect  the 
table  entry  mati^  "8B  FRED  UNASSIGNED*  (This  entry  cotie^nds  to  die  RWA 
simulate).  This  will  open  up  to  a  ctmfiguraticHi  menu.  Select  die  [A  COMPANY]  butum, 
then  select  [OK]  buttoiL  This  screen  wffl  closedown  and  show  tlmt  Simulator  8B  FRED  is 
assigned  to  A  company.  Select  the  [OVERVIEW]  button  to  return  to  the  Exncise 
hutializatioQ  screen. 


4.)  Select  [VEHICLE  PLACEMENT]  dien  [GO].  This  will  Ixing  op  the  Vehicle 
Flaceoaent  screen.  Select  [A  COMPANY]  then  [NEXT].  A  screen  label^  "Vehicle 
SimulattMr  Initialization"  will  appear  for  A  Company.  Select  die  entry  for  Simulator  8B,  a 
new  screen  wiD  open  for  vehicle  ^lecific  oitry.  On  the  next  screen,  select  die  [DK^SE] 
button.  Then  enter  the  number  1  in  the  "Bumper  Number^  field  and  press  the  "tab"  key. 
Enter  "es742779"  in  the  "Location”  field  and  press  the  "tab”  key.  Enter  "1800"  in  the 
Azimuth"  field  and  then  select  die  [PLACE]  tmtton  with  tte  mouse.  The  screen  will  close 
down  and  the  screen  will  show  the  8B  FRED  Simulator  placed  at  the  location  you  entered. 
Select  the  [OVERVIEW]  button  to  roum  to  die  exercise  initialization  screen. 


5.)  Select  [BATTLEMASTER  FUNCTIONS]  then  [GO].  A  password  screen  will 

appur.  Eitter  die  battlemaster  password  (foorball)  and  a  new  soeen  will  appear  containing 
die  baltimuwtrr  functions.  Selkt  [GUNNERY  TARGETS]  dien  [GO].  Ascreen  labeled 
"Onmiery  Targets”  will  appear.  Enter  the  following  in  order. 

IRXCEl  []  indicales  a  mouse-click  entry,  <>  indicates  user  input 

[NEW  TARGET)  <tgtl>  tab-key  <es854773>  tab-key  <4800>  [OK] 

[NEW  TARGET]  <tgt2>  tab-key  <es839773>  tab-key  <4800>  [OK] 

[NEW  TARGET]  <^>  tab-key  <es839773>  tab-key  <4800>  [OK] 

[NEW  TARGET]  <tgt4>  tab-key  <es839773>  tab-key  <4800>  [OK] 


5 


ADST/WDL/TR--92-003027 


November  22, 1992 


[NEW  TARGET)  <tgt5>  tab-key  <es818772>  tab-key  <6000>  [OK] 
[NEW  TARGET)  <tgt6>  tab-key  <es818773>  tab-key  <6000>  [OK] 
[NEW  TARGET)  <tgt7>  tab-key  <es817774>  tab-key  <5800>  [OK] 
[NEW  TARGET]  <tgt8>  tab-key  <es804781>  tab-key  <5000>  [OK] 
[NEW  TARGET]  <tgt9>  tab-key  <es783806>  tab-key  <5800>  [OK] 
[NEW  TARGET]  <tgtlO>  tab-key  <es771809>  tab-key  <4000>  [OK] 
Select  [OVERVIEW]  to  return  to  battlemaster  functions. 


6.)  Ensure  that  the  RWA  has  initialized  in  the  database  by  observing  that  the  database 
terrain  is  di^layed  on  the  7  TV  monitors  above  the  RWA  cocIq)it,  the  Mgh  resolution 
channd  is  operational  by  observing  that  there  is  a  picture  displayed  on  the  TV  monitor  at 
the  Co-pilot-gunner  (CPG)  station,  and  the  sound  is  on. 

NOTE:  for  the  remainder  of  this  paragraph,  "R-M-C"  means  "Click  the  right  mouse  button" 
On  the  Plan  View  Display  (PVD),  in  the  lower  right  hand  comer  of  the  screen,  in  the  blodc 
labeled  "Other  Menus",  R-M-C  until  "Top  Menu  1"  is  displayed.  Then  in  the  block  labeled 
"DATABASES",  ensure  that  the  "FT_KNOX"  box  contains  an  "X".  If  not,  R-M-C  on  the 
FT.KNOX  box  to  select  it  (If  FT.KNOX  was  not  selected,  the  displayed  map  wdl  be 
redrawn.  This  may  take  a  few  minutes.)  Then  in  the  block  labeled  "MAP  FEATURES",  R- 
M-C  the  box  containing  "SET  GRID"  untU  "SET  GRID  OFF  is  displayed.  Then  R-M-C 
the  selection  in  "OTHER  MENUS"  labeled  "Top  Menu  1".  You  will  now  be  in  Menu  2.  In 
the  block  labeled  "MAP  MANIPULATION",  R-M-C  the  selection  "Top  Level".  The  cutsot 
will  turn  into  a  "wait"  icon  and  the  map  will  displayed  at  full  view.  At  this  point  the 
PVD  map  display  will  dl^lay:  rivers,  roads,  tree  hnes,  lakes,  tree  canopies,  and  icons 
representing  vehicles.  Now,  move  the  cursor  onto  the  map  until  the  tail  of  the  cursor  is 
positioned  in  the  lower  right  hand  comer  of  the  grid  block  located  third  from  top  and  fourth 
from  left  Holding  the  left  mouse  button  down,  drag  open  a  window  outlining  me  grid 
square  which  contains  the  target  icons  and  release  the  mouse  button.  Then  move  the  cursor 
to  the  "MAP  MANIPULATION"  block  and  R-M-C  on  the  "Zoom  In"  selection.  The  cursor 
will  turn  into  a  "wait"  cursor.  Wait  iqiprox.  two  minutes  and  the  map  wUl  display  a  close- 
up  view  of  the  gaming  area. 


7.)  Lift  off  in  the  RWA  simulator,  fly  a  heading  of  120  degrees  at  an  altitude  of  about 

ft  Above  Ground  Level  (AGL)  until  reaching  location  "ES866734"  (displayed  on  the 
Situation  Awarraess  Di^lay  (SAD)).  Turn  left  to  350  degrees  and  fly  to  location 
"ES863763".  Go  into  a  "hover"  at  about  100  ft  AGL,  the  Co-Pilot-Gunner  (CITC)  will 
select  Hellfire,  acquire  a  lock  on  the  target  located  direcdy  ahead,  fire  a  missile  holding  the 
laser  trigger  down,  if  the  target  is  not  desttoyed,  repeat  firing  un^  a  kill  is  achieved,  '^e 
pilot  will  then  fly  a  heading  of 250  degrees  ^ong  the  road  where  several  other  targets  are 
located,  destroy  the  remainder  of  targets  using  HeUfires  and  gun.  During  the  fli^t,  the 
pilot  w^  execute  maneuvers  necessary  to  test  the  flight  characteristics  of  the  RWA 
helicopter. 


8.)  The  test  is  concluded  by  returning  to  die  MCC  SCC  console,  ratering  the 
Batdemaster  Functions  screen,  and  selecting  [End  Exercise]  then  [go].  Then  answer  [yes] 
to  the  confirmation  question.  At  this  time,  the  RWA  simulator  will  stop. 
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Appendix  B  RWA  Build  Instructions 

1.  Once  all  the  code  is  in  the  respective  RWA  directory  and  in  RCS,  log  on  to  the  SUN 
system  on  adst30  under  the  cm-adst  account. 

2.  The  RWA  delivery  order  is  divided  into  common  and  simnet  software.  The  common 
software  must  be  built  first  Set  the  default  (tirectory  to  common. 

cd  common 

If  you  want  to  build  firmn  scratch,  remove  all  the  library  (*.&)  and  object  files  (*.0)  by 
executing  a  make  clean. 

make  clean  (deletes  all  *.a  and  ’*.0  files) 

If  you  only  want  to  build  these  object  modules  that  changed  as  a  result  of  the  source  file 
b^g  modified,  then  only  delete  the  associated  object  files.  Set  default  to  the  directory 
where  the  object  module  is  located  and  delete  it 

cd  RWA/common/libstc/libmem 
nn  filename.o 

3.  Execute  the  following  set  of  commands  to  build  the  RWA  conunon  oivironment  from 
scratch: 


make  checkout  (Fetches  a  read-only  copy  of  all  source  files  from  R(}S  if  the 
latest  version  doesn't  alt^y  exist  in  the  local  directory), 
make  install  (Compiles  source  and  creates  object  files.  It  will  not  compile 
error  free). 

If  you  want  to  produce  a  log  file  for  standard  ou^ut  and  error  log  messages,  enter  the 
following  comnumd: 

(make  install  >  rwa_commonJnstalLstdlog)>&  rwa_commonJinstalI.errlog 

These  log  files  will  be  located  in  the  default  directory  (/RWA/common). 

4.  Execute  the  following  set  of  ^mmands  to  build  the  RWA  simnet  environment  from 
scratch: 


cd  .isimnet 

makeheados  (Moves  archive  files  and  headers) 
make  install  (Compiles  source  and  creates  object  files.  It  will  not  compile 
error  free). 

make  all  (Copies  rwa  executable  to  the  bin  directory). 

(If  you  want  to  {noduce  a  log  file  for  standard  ou^ut  and  error  log  messages,  enter  the 
following  comrnand: 

(make  install  >  rwa_simnet_install.stdlog)>&  rwajsimnet_install.etrlog 
These  log  files  will  be  located  in  the  default  directory  (/RWA/simnet). 
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5.  To  build  only  the  files  that  change,  delete  the  object  file(s)  that  are  being  changed,  and 
copy  the  modifi^  file(s)  from  turnover  to  the  designated  rwa  directory  and  execute  only  the 
malm  install  command  as  discussed  in  Steps  3  and  4  of  this  procedure. 

6.  A  successful  compilation  and  link  produces  an  executable  called  rwa.  It  is  located  in  the 
fiiWA/simnei/vehicl^rwa/src  directory. 

7.  Create  two  tapes  with  the  the  rwa  executable  and  data  files  for  testing  using  the 
following  tar  commands: 

cd  /RWA/vehicle/rwa/src 
tar  cvf  adstl  :/dev/rstO  rwa 

cd  /RWA/data/vdiicle/data 
tar  cvf  adstl  :/dev/rstO  *.d 
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Appendix  C  Installation  Instructions 

&WA _ Software _ Installation _ instructions 

PURPOSE;  To  Install  a  software  release 

1 . )  After  the  GTl  1 1  system  has  been  powered  up,  a  "GT-0>"  prompt  will  be  displayed 
on  the  console.  The  release  to  be  installed  will  be  furnished  on  ISOmb  cartridge  tapes  in 
"tar"  format  Install  the  tape  containing  the  RWA  release  executable  (rwa)  into  the  t^ 
drive,  wait  until  the  tape  rewinds  to  Begiiming  of  Tape  (BOT)  (indicated  by  the  LED  on  the 
fremt  of  the  tape  drive  changing  from  to  solid  green.  This  may  take  a  minute  or  so 
depending  on  where  the  tape  is  positioned  in  die  cartridge). 

2. )  The  RWA  executable  belongs  in  the  directory  A:/SIMNET/BIN.  When  step  1  has 

bera  successfully  performed,  at  the  GT-()>  prompt,  enter  the  following  commands: 

NOTE:  <cr>  indicates  the  "return"  key  is  pressed. 

cd/simnet/bin  <cr> 
tarxv<cr> 

(The  rwa  executable  (rwa)  will  be  read  in  from  tape.) 
cd<cr> 

Remove  the  tape  from  the  tape  drive. 

3. )  If  the  release  cemtains  related  data  files,  these  belong  in  the  directory 

Ai/SIMNET/DATA.  When  step  2  has  been  successfully  performed,  at  the  GT-0>  prompt, 
inseit  the  tape  cemtaining  the  di^  files  into  the  tape  drive  and  wait  for  the  LED  on  the  tape 
drive  to  go  to  solid  green.  Then  enter  the  following  commands: 

cd  /siiniiet/data  <ct> 
tarxv<cr> 

(The  rwa  data  file(s)  will  be  read  in  from  tape.) 
cd<cr> 

4. )  The  installation  is  now  complete.  Remove  the  tape  cartridge  from  the  tape  drive  and 

reboot  the  system  by  entering  "rebrot"  at  the  GT-0>  prompt 
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GTOS5.7  Release  Notes 
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Appendix  E  RWA  source  listings 


RWA  BDS-DI.0.0  Prologue  Description 

The  baseline  code  for  RWA  BDS-D  1.0.0  is  documented  in  listings  attached  to  this 
Appendix.  Starting  at  the  top  of  the  RWA  directory  tree,  a  history  of  each  tile  is  produced 
from  the  Revision  Control  System  (RCS)  subdirectories.  All  baselined  RWA  tiles  are 
chedted  into  the  RCS  subdirectories.  RCS  tiles  (denoted  by  the  ",v")  and  its 
corresponding  working  tile  make  up  each  dir»;tory  in  the  RWA  directory  tree.  Along  with 
each  filename  is  a  brief  description  of  the  reason  for  the  check  in.  For  example,  "Initial 
Turnover  -  BBN*s  6.6.1"  documents  the  reason  for  checking  the  code  into  RCS.  RCS 
automatically  supplies  a  version  number.  Each  tile  checked  into  RCS  is  a  given  version 
number  of  1.1.  Version  numbering  is  incremented  in  tenths  (1.2, 1.3, 1.4,  etc.,). 

A  snapshot  of  what  was  turned  over  by  BBN  and  successfully  built  and  tested  was 
brought  under  LORAL  contiguration  management  control  via  RCS  and  assigned  a  release 
number  of  BDS-D  RWA  1.0.0.  BDS-D  RWA  1.0.0  consists  of  all  the  source  code 
required  to  produce  the  RWA  executable,  and  contiguration  and  data  tiles  necessary  to  run 
die  RWA  tqpp&ation. 
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RWA  Common  Software  Listings 


